CallPredispatchProc

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODSemanticInterface

CallPredispatchProc
The CallPredispatchProc method calls the predispatch handler for this semantic interface's part.
void CallPredispatchProc (in ODPart thePart, 
                          in ODAppleEvent theODAppleEvent, 
                          in ODAppleEvent reply);
thePart
A reference to the part associated with this semantic interface object.
theODAppleEvent
A reference to an Apple event object.
reply
A reference to an Apple event object reply that it is appropriate for the part to return.

DISCUSSION
OpenDoc calls this method for each semantic interface registered to receive predispatched Apple event objects. This method gives your semantic interface a chance to react to events that may not be destined for your part. For example, OpenDoc does not forward recording-on and recording-off events to parts that are not direct recipients, so your part can use this method to detect those events.
Before OpenDoc calls your override of this method, you must call your semantic interface object's UsingPredispatchProc method and pass the value of kODTrue in for the usingNotUsing parameter. Your override of this method should not raise any exceptions under normal conditions.

EXCEPTIONS
The Apple Event Manager may throw an exception if this method is unable to receive predispatched Apple event objects.
This method may throw platform-specific exceptions.

SEE ALSO
The ODSemanticInterface::UsingPredispatchProc method (page 600).
The ODAppleEvent class (page 41).